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(54) A method and apparatus for allowing generic stubs to marshal and unmarshal data In object 
reference specific data formats 



(57) The invention provides solutions to the prob- 
lems which are encountered by object oriented systems 
designers when attempting to implement schemes for 
object invocation and for argument passing in distrib- 
uted systems wherein the arguments may be objects, 
and wherein the system supports a multiplicity of ORB- 
specific data formats, in ways which do not lock the 
object oriented base system into methods which may be 
difficult to change at a later time. Moreover, the inven- 
tion disclosed describes a "Marshal Buffer 
mechanism" which contains methods for marshaling 
data for a specific ORB; a "Multl-ORB Marshaling 
system" which permits a Client Application and related 



stub to invoke an operation on a target object without 
any knowledge or concern about which ORB this target 
object uses or what data format the ORB requires for 
the arguments of the operation invoked; and a "Compu- 
ter system for multi-ORB communication" compris- 
ing an ORB independent layer which contains Client 
Applications and stubs; an ORB dependent-OS inde- 
pendent layer which contains ORB dependent 
code/Subcontract code mechanisms as well as ORB 
specific Marshal Buffers for a multiplicity of ORBs; and 
an Operating System (OS) layer. 
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Description 

The present invention relates to the fields of distrib- 
uted computing systems, client-server computing and 
object oriented programming. 

Specifically, the present invention relates to a 
method and apparatus for providing program mecha- 
nisms which allow generic stubs to marshal and unmar- 
shal data in object-reference-specific data formats. 

A key problem in modern object oriented distributed 
processing systems is permitting object applications to 
communicate with a new object request broker ("ORB") 
which has its own unique data format, with only minor 
modification to the supporting code mechanisms. Simi- 
larly client applications and stubs should be able to 
communicate seamlessly with different ORBs in a sys- 
tem which can communicate with a multiplicity of ORBs 
wherein each of the ORBs has its own unique data for- 
mat. 

For example, the Object Management Group 
(OMG) is an industry standards organization that is cre- 
ating multi-vendor standards for distributed object-ori- 
ented programming. One of the cornerstones of the 
OMG work has been the definition of a common Inter- 
face Definition Language, known as IDL f that is now in 
widespread use as a standard way for defining inter- 
faces to network objects in a way that is independent of 
the particular network protocols that are being used or 
the particular programming languages that are being 
used by the clients and the servers. 

> The IDL language is object-oriented and supports 
multiple inheritance. It comes with a rich set of built-in 
primitive types (such as floats, booleans, etc.) and also 
defines a set of structured types including structs, 
unions and sequences. 

The Object Management Group standardized on 
the IDL interface definition language as a uniform way of 
defining interfaces to network objects. However, the 
OMG initially left the on-the-wire protocol and data for- 
mats undefined. As a result different vendors imple- 
mented ORBs with different protocols and different data 
formats. 

Recently the OMG has agreed on a common ORB 
inter-operability protocol, the Universal Networked 
Objects (UNO) protocol. However this is primarily 
viewed as a gateway protocol for connecting object sys- 
tems from different vendors. At least in the short term 
different vendors appear likely to continue to use their 
existing protocols for higher performance within their 
own object systems, while supporting lower perform- 
ance UNO gateways to other ORBs. Thus a current 
need exists to permit object applications to transpar- 
ently communicate with these ORBs with different pro- 
tocols and different data formats. 

For further description of object oriented design 
and programming techniques see "Object-oriented 
Software Construction" by Bertrand Meyer, Prentice- 
Hall 1988. For further information on OMG, CORBA, 
ORBs and IDL see the "Common Object Request Bro- 



ker: Architecture and Specification", Revision 2.0, July 
1955 which is hereby fully incorporated herein by refer- 
ence. 

Currently Internet browsers are very limited in their 

5 ability to interact with network servers. Typically a 
browser such as Mosaic will down-line load an HTML 
document and then wait passively for a human user to 
either select another document or to enter HTML forms 
information that can be passed back to the server. 

10 Two new developments are promising to make the 
Internet a more dynamic environment. The first is sup- 
port for scripting languages in Internet browsers (such 
as the Sun Microsystems, Inc. (SUN) JAVA language 
described below) so that a browser can download and 

is execute interactive scripts. This transforms browsers 
from being passive viewers into being dynamic agents 
that can interact with the Internet on a user's behalf and 
display rapidly changing information. The second devel- 
opment is the widespread adoption of the Object Man- 

20 agement Group's distributed object interfaces based on 
the IDL interface definition language. These provide a 
standard way for network servers to export services as 
"network objects" in a language and vendor independ- 
ent way. This will make it much easier to build network 

25 services that can be transparently accessed from differ- 
ent client environments. 

Java 

30 Java is a strongly typed object-oriented language 
with a C like syntax. The Java compiler and run-time 
code mechanisms enforce type safety so that there can 
be no wild pointers or other references that violate the 
languages type system. So for example, there is no 

35 "void *" and all casts are validated at runtime. 

The Java language is typically compiled to 
machine-independent byte-codes and then a Java vir- 
tual machine interprets those byte codes in order to exe- 
cute the Java program. Java can be integrated into 

40 network HTML browsers, so that as part of viewing a 
document one can down-line load a set of Java byte- 
codes and then execute them on the client machine. 
Because Java is completely typesafe the client browser 
can feel confident that the Java program can be exe- 

45 cuted safely without endangering the security or integ- 
rity of the client. Java is more fully described in The 
Java Language Specification" release 1.0 Alpha3, by 
Sun Microsystems, Inc. dated May 11, 1995 which is 
hereby fully incorporated herein by reference. 

so Scripted language systems like Java generate Java 
programs that are designed to be portable and to be 
deployed in a variety of different environments. It is 
therefore desired to allow Java programs to use different 
ORBs without requiring any changes to the Java pro- 

55 gram. Because the generated stubs are part of the Java 
program it is necessary that the stubs be ORB-inde- 
pendent so that the Java program and its associated 
stubs might be used in any of a multiplicity of ORBs. 
This disclosure describes a solution to the basic 
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problem by creating a generic interface between the 
stubs and ORB specific data mechanisms. These ORB 
specific data mechanisms include one or more Marshal 
Buffer Objects which have methods for marshalling and 
unmarshalling one or more particular ORB related on- 
the-wire data formats and a method and apparatus for 
using an object reference (Objref) to indicate the partic- 
ular Marshal Buffer Object to use for this particular 
Object call. 

SUMMARY OF THE INVENTION 

The present invention provides an elegant and sim- 
ple way to provide mechanisms for invocation of objects 
by client applications and for argument passing 
between client applications and object implementations, 
without the client application or the operating system 
knowing the details of how these mechanisms work. 
Moreover, these mechanisms functions in a distributed 
computer environment with similar ease and efficiency, 
where client applications may be on one computer node 
and object implementations on another. 

In one aspect of the invention, a "Computer sys- 
tem for multi-ORB communication" is disclosed 
which includes an Object Request Broker (ORB) inde- 
pendent layer which contains Client Applications and 
stubs; an ORB dependent-OS independent layer which 
contains ORB dependent code/Subcontract code 
mechanisms as well as ORB specific Marshal Buffers 
for a multiplicity of ORBs; and an Operating System 
(OS) layer. 

In another aspect, a "Multi-ORB Marshaling 
system* is disclosed which permits a Client Application 
and related stub to invoke an operation on a target 
object without any knowledge or concern about which 
ORB this target object uses or what data format the 
ORB require for the arguments of the operation invoked. 

In yet another aspect, the invention disclosed 
describes a "Marshal Buffer mechanism" which con- 
tains methods for marshaling data for a specific ORB. 

In another aspect of the invention, a computer per- 
formed method of processing calls from a client applica- 
tion to an ORB requiring a specific data format is 
disclosed wherein the client application and its related 
stub are not required to know which ORB is being used 
or which format is required for the data. The method 
includes a process for finding a MarshalBuffer which 
can provide the correct data format marshaling for the 
correct ORB. 

Similarly, the claimed invention includes a computer 
program product embodying these inventive mecha- 
nisms. 

The present invention will now be further described, 
by way of example, with reference to the accompanying 
drawings, in which:- 

Figure 1 illustrates the configuration of a typical 
computer hardware system used with and as a part 
of the present invention. 



Figure 2 illustrates the prior art relationship of client 
and server applications to stubs and network soft- 
ware. 

Figure 3 illustrates a system showing Java ORB 
5 classes. 

Figure 4 illustrates the relationship between stub 
objects, ORB specific code/subcontract mecha- 
nisms, and server application objects in a single 
ORB system. 

10 Figure 5 illustrates remote object invocation using 
ORB specific code/subcontracts, ORB-specific 
MarshallBuffer mechanisms in a multi-ORB sys- 
tem. 

Figure 6 illustrates an exemplary MarshallBuffer 
is code mechanism. 

Figure 7 illustrates a more specific remote object 
invocation using ORB specific code/subcontracts, 
ORB-specific MarshallBuffer mechanisms in a 
multi-ORB system. 

20 

NOTATIONS AND NOMENCLATURE 

The detailed descriptions which follow may be pre- 
sented in terms of program procedures executed on a 

25 computer or network of computers. These procedural 
descriptions and representations are the means used 
by those skilled in the art to .most effectively convey the 
substance of their work to others skilled in the art. 
A procedure is here, and generally, conceived to be 

30 a self-consistent sequence of steps leading to a desired 
result. These steps are those requiring physical manip- 
ulations of physical quantities. Usually though not nec- 
essarily, these quantities take the form of electrical or 
magnetic signals capable of being stored, transferred, 

35 combined, compared, and otherwise manipulated. It 
proves convenient at times, principally for reasons of 
common usage, to refer to these signals as bits, values, 
elements, symbols, characters, terms, numbers, or the 
like. It should be noted, however, that all of these and 

40 similar terms are to be associated with the appropriate 
physical quantities and are merely convenient labels 
applied to these quantities. 

Further, the manipulations performed are often 
referred to in terms, such as adding or comparing, 

45 which are commonly associated with mental operations 
performed by a human operator. No such capability of a 
human operator is necessary, or desirable in most 
cases, in any of the operations described herein which 
form part of the present invention; the operations are 

so machine operations. Useful machines for performing 
the operations of the present invention include general 
purpose digital computers or similar devices. 

The present invention also relates to apparatus for 
performing these operations. This apparatus may be 

55 specially constructed for the required purposes or it may 
comprise a general purpose computer as selectively 
activated or reconfigured by a computer program stored 
in the computer. The procedures presented herein are 
not inherently related to a particular computer or other 
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apparatus. Various general purpose machines may be 
used with programs written in accordance with the 
teachings herein, or it may prove more convenient to 
construct more specialized apparatus to perform the 
required method steps. The required structure for a vari- 
ety of these machines will appear from the description 
given. 

DESCRIPTION OF THE PREFERRED EMBnniMFMT 

The following disclosure describes solutions to the 
problems which are encountered by object oriented sys- 
tems designers when attempting to implement schemes 
for object invocation and for argument passing in distrib- 
uted systems wherein the arguments may be objects, in 
ways which do not lock the object oriented base system 
into methods which may be difficult to change at a later 
time. Moreover, the invention disclosed describes a 
"Marsha! Buffer mechanism" which contains opera- 
tions (called "methods" in Object Oriented programming 
parlance) for marshaling data for a specific ORB; a 
"Multi-ORB Marshaling system" which permits a Cli- 
ent Application and related stub to invoke an operation 
on a target object without any knowledge or concern 
about which ORB this target object uses or what data 
format the ORB requires for the arguments of the oper- 
ation invoked; and a "Computer system formultiORB 
communication" comprising an ORB independent 
layer which contains Client Applications and stubs; an 
ORB dependent-OS independent layer which contains 
ORB dependent code/Subcontract code mechanisms 
as well as ORB specific Marshal Buffers for a multiplicity 
of ORBs; and an Operating System (OS) layer. The 
"ORB dependent code mechanism" used in the 
present invention, is analogous to the "subcontract 
mechanism" which is associated with each object and 
which is described in co-pending patent application 
serial number 07/995,863 filed 12/21/92 which is incor- 
porated fully herein by reference. 

In the following description, for purposes of expla- 
nation, specific data and configurations are set forth in 
order to provide a thorough understanding of the 
present invention. The preferred embodiment described 
herein is implemented as a portion of the SPRING-DIS- 
TRIBUTION Object-Oriented Operating System created 
by Sun Microsystems®, Inc. (Sun Microsystems is a 
registered trademark of Sun Microsystems, Inc.) How- 
ever, it will be apparent to one skilled in the art that the 
present invention may be practiced without the specific 
details and may be implemented in various computer 
systems and in various configurations, or makes or 
models of tightly-coupled processors or in various con- 
figurations of loosely-coupled multiprocessor systems. 
The Spring-Distribution Object-Oriented Operating Sys- 
tem is described in "A Spring Collection" A collection of 
Papers on the Spring distributed Object-Oriented Oper- 
ating System published September 1994 by sun Micro- 
systems, Inc. which is hereby fully incorporated herein 
by reference. 



ADDITIONAL BACKGR OUND INFORMATION 
Operating Environment 

5 The environment in which the present invention is 
used encompasses the general distributed computing 
system, wherein general purpose computers, worksta- 
tions, or personal computers are connected via commu- 
nication links of various types, in a client-server 

io arrangement, wherein programs and data, many in the 
form of objects, are made available by various members 
of the system for execution and access by other mem- 
bers of the system. Some of the elements of a general 
purpose workstation computer are shown in Figure 1, 

is wherein a processor 1 is shown, having an InpuVoutput 
("I/O") section 2, a central processing unit ("CPU") 3 
and a memory section 4. The I/O section 2 is connected 
to a keyboard 5, a display unit 6. a disk storage unit 9 
and a CD-ROM drive unit 7. The CD-ROM unit 7 can 

20 read a CD-ROM medium 8 which typically contains pro- 
gram code mechanisms 10 and data. 

Stubs 



25 Techniques for providing a language-level veneer 
for remote operations (for example, "Remote Procedure 
Calls") have been in use for many years. Typically these 
take the form that a remote interface is defined in some 
language. Then a pair of stubs are generated from the 
30 interface. The client stub, runs in one machine and 
presents a language level interface that is derived from 
the remote interface. The server stub runs in some 
other machine and invokes a language-level interface 
that is derived from the remote interface. Referring now 
35 to Figure 2, to perform a remote operation, a client 
application 12 on one machine 11, invokes the client 
stub 14, which marshals the arguments associated with 
the invocation into network buffer(s) and transmits them 
to the server stub 22 on the remote machine 18, which 
40 unmarshals the arguments from the network buffer(s) 
and calls the server application 24. Similarly, when the 
server application 24 returns a response, the results are 
marshaled up by the server stub 22 and returned to the 
client stub 1 4, which unmarshals the results and returns 
45 them to the client application 1 2. The entire mechanics 
of argument and result transmission, and of remote 
object invocation, are performed in the stubs. Both the 
client application and the server application merely deal 
in terms of conventional language-level interfaces. 
so When the arguments or results are simple values 
such as integers or strings, the business of marshaling 
and unmarshaling is reasonably straightforward. The 
stubs will normally simply put the literal value of the 
argument into the network buffer. However, in lan- 
55 guages that support either abstract data types or 
objects, marshalling becomes significantly more com- 
plex. One solution is for stubs to marshal! the internal 
data structures of the object and then to unmarshal this 
data back into a new object This has several serious 
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deficiencies. First, it is a violation of the "abstraction" 
principle of object-oriented programming, since stubs 
have no business knowing about the internals of 
objects. Second, it requires that the server and the cli- 
ent implementations of the object use the same internal 5 
layout for their data structures. Third, it may involve mar- 
shalling large amounts of unnecessary data since not 
alf of the internal state of the object may really need to 
be transmitted to the other machine. An alternative solu- 
tion is that when an object is marshalled, none of its w 
internal state is transmitted. Instead an identifying token 
is generated for the object and this token is transmitted. 
For example in the Eden system, objects are assigned 
names and when an object is marshalled then its name 
rather than its actual representation is marshalled. Sub- 75 
sequently when remote machines wish to operate on 
this object, they must use the name to locate the original 
site of the object and transmit their invocations to that 
site. This mechanism is appropriate for heavyweight 
objects, such as files or databases, but it is often inap- 20 
propriate for lightweight abstractions, such as an object 
representing a cartesian coordinate pair, where it would 
have been better to marshal the real state of the object. 
Finally, some object-oriented programming systems 
provide the means for an object implementation to con- 2 s 
trol how its arguments are marshalled and unmar- 
shalled. For example, in the Argus system object 
implementors can provide functions to map between 
their internal representation and a specific, concrete, 
external representation. The Argus stubs will invoke the 30 
appropriate mapping functions when marshalling and 
unmarshaling objects so that it is the external represen- 
tation rather than any particular internal representation 
that is transmitted. These different solutions all either 
impose a single standard marshalling policy for all 35 
objects, or require that individual object implementors 
take responsibility for the details of marshalling. An 
advanced object marshaling process is described in the 
above referenced co-pending patent application serial 
number 07/995,863 filed 12/21/92 which describes 40 
"Subcontracts." 

Current Problem Summary 

Specific Problem for Current Object Oriented Sys- 45 
terns 

The specific problem here is that different ORBs 
have different on-the-wire data formats. So one ORB 
might marshal bytes in little-endian order, another in so 
big-endian, etc. Different ORBs also have different on- 
the-wire formats for arrays, strings, unions, etc. 

So it is desirable to have ORB independent stubs 
that can marshal their data differently when talking to 
different objects. Thus, one might use a DEC data for- ss 
mat when talking to a DEC object and a Sun data format 
when talking to a Sun object. And it is desirable for one 
to allow a single set of stubs to be in simultaneous use 
with different ORBs. 



Proposed Solution to the Problem 

The solution is; 

(1) define a generic interface for marshalling. This 
generic interface provides methods for marshalling 
and unmarshalling ints, shorts, bytes, chars, and 
strings. But it says nothing about how these meth- 
ods are implemented. 

(2) Different ORBs provide their own implementa- 
tion of the generic marshal buffer interface. As well 
as supporting the generic marshalling and unmar- 
shalling methods, these ORB specific marshal 
classes may provide additional methods for mar- 
shaling ORB specific data. For example the Spring 
ORB implementation of MarshalBuffer provides 
methods for marshalling and unmarshalling Spring 
doors. 

(3) Each object reference (Objref) contains a 
pointer to a set of ORB runtime machinery that 
belongs to the ORB that implements that object. In 
the preferred implementation this consists of a 
pointer to the client side ORB-dependent code 
mechanism/subcontract for the object. 

(4) The ORB runtime machinery described in (3) 
will support a method for obtaining a MarshalBuffer 
object. The runtime machinery will return a Mar- 
shalBuffer object that implements the correct mar- 
shalling and unmarshalling for that ORB. 

(5) The generic stubs work entirely in terms of the 
o generic MarshalBuffer interface. 

(6) At the beginning of each call, the generic stubs 
call into the ORB specific runtime code mecha- 
nisms associated with the object reference to get 
an appropriate MarshalBuffer object. The stubs 
then use the generic marshalling and unmarshal- 
ling interfaces to marshal and unmarshal data to 
and from that MarshalBuffer object. Since the 
implementations of these marshal and unmarshal 
methods are ORB specific, this means that the data 
is being marshalled and unmarshalled in an ORB 
specific way. 

In the currently preferred embodiment; the generic 
MarshalBuffer includes additional capabilities for han- 
dling differences in several known ORBs. For example, 
(a) in addition to methods for marshalling and unmar- 
shalling simple data types, the generic MarshalBuffer 
provides a way for Marshalling array descriptors. This 
method takes the bounds of the array and then mar- 
shals an array descriptor in an ORB specific way. For 
example, the DOE ORB code marshals the length of the 
array. But the Spring ORB code marshals the lower 
bound and the upper bound, and (b) similarly provides 
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mechanisms for unmarshalling an array descriptor. 
HOW TO MA KE AND USE THE INVENTION 
A Portabl e ORB implementation 

One of the goals for the preferred embodiment of 
the present invention is for the Java ORB implementa- 
tion to be allowed to work directly with a variety of differ- 
ent on-the-wire protocols and data formats. In 
particular, a single Java program must be able to simul- 
taneously use object references that refer to objects in 
different ORBs, The internet is a very heterogeneous 
environment and it is desired not to restrict Java IDL cli- 
ents to only working with a single server at a time. 

In particular the Java ORB implementation of the 
preferred embodiment must be able to communicate 
directly with both Sun's Distributed Object Environment 
(DOE)and with the Spring distributed operating system. 
It is also desired to design the Java ORB core so that it 
could communicate with UNO gateways or with DCE 
based object systems. 

Portability issues 

Portability is an issue at several different levels. 

At the lowest level. Java's socket class is used to 
get machine and OS independent access to the IP pro- 
tocol family. 

At the next level up, different ORBs use different 
low-level network transport protocols. For example, 
Sun's DOE systems uses ONC RPC, the Spring system 
uses an optimized sequenced packet protocol, UNO 
uses TCP/IP, some other vendors use DCE RPC, etc. 
However, while this may seem like fairly major differ- 
ence it is actually comparatively easy to plug in different 
low level transport protocols. 

Unfortunately, the different transport protocols also 
come with different data formats for simple data types. 
For example, integer values may have to be transmitted 
in big-endian byte order for an ONC ORB and in little- 
endian byte order for a DCE ORB. This affects the way 
that one can marshal and unmarshal arguments from 
the marshal buffers. 

At the next level up, even if two ORBs agree on a 
standard format for simple data types, they may disa- 
gree on how to handle the IDL structured data types. 
For example both the Spring ORB and the DOE ORB 
use the ONC XDR format for simple data types, but 
when they transmit an array descriptor the DOE ORB 
simply transmits an integer specifying the length, 
whereas the Spring ORB transmits two integers, one 
specifying the array's lower bound and the other speci- 
fying the array's upper bound. This means that if one 
wants to have stubs that can be used between different 
ORBs then the stubs cant directly marshal things like 
array descriptors, but instead must call into some ORB 
specific code. 

Finally there are likely to be different formats for the 



various kinds of IDL related meta-data, such as object 
references, method identifiers, exception identifiers, and 
type identifiers. For example, Spring uses integers as 
method identifiers. Other ORBs send either a simple 
5 method name of a fully qualified interface name plus 
method name combination. 

The portability strategy 

10 In the preferred embodiment, the general strategy 
has been to create stubs that are ORB independent and 
to conceal the ORB dependencies inside the individual 
object references. This has the major advantage that a 
single Java stub compiler can be used that can gener- 
15 ate stubs that can be used with any ORB. However this 
means that there must be interfaces between the stubs 
and the object reference that allow the stubs to marshal 
arguments and invoke remote operations in an ORB 
independent manner. 
20 Experience with using the Subcontract mechanism 
in the Spring system was used in designing the separa- 
tion between the stubs and the ORB specific layer. 
Spring permits different object references to have differ- 
ent formats and to have different invocation mecha- 
25 nisms, so as to be able to support things like replication 
and data caching. It does this by associating a software 
module called a subcontract with each object refer- 
ence. When the Spring stubs want to marshal or invoke 
an object reference, they call into the subcontract asso- 
30 dated with the object reference, so that the marshalling 
or object invocation is performed in a way that is appro- 
priate to that subcontract. 

In the JAVA ORB implementation of the preferred 
embodiment one extra abstract interface was added so 
35 that a single set of stubs could communicate with multi- 
ple ORBs. An abstract MarshalBuffer interface was 
added and the creation of MarshalBuffers was moved 
from the stubs into the subcontracts, so that different 
ORBs could provide different sub-classes of Marshal- 
40 Buffer which marshalled and unmarshalled data in the 
correct format for that ORB. Figure 3 provides an illus- 
tration of the Java ORB classes. In Figure 3, A Java 
Application 70 uses a set of stubs 68 to talk to a set of 
remote objects (not shown). These stubs and applica- 
45 tions comprise an "ORB independent" layer 69 which 
interface generically with the "OS Independent/ORB 
dependent" layer 61. An exemplary "OS Independ- 
ent/ORB dependent" layer 61 comprises, for example, 
two different Spring subcontract mechanisms 66, 64 
so that use the same MarshalBuffer 60 and the same 
Spring network protocol code mechanism 56 to talk to 
the remote object (not shown). An ORB dependent 
code mechanism 62 for use by Sun's DOE ORB is 
shown, which uses a DOE MarshalBuffer 58 which in 
55 turn uses the DOE network protocol code mechanism 
54. In this example, both the Spring network protocol 
code mechanism 56 and the DOE network protocol 
code mechanism 54 use the Java network "Socket" 
code mechanism 52. (The Java "Socket" class provides 
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access to TCP/IP and UDP functionality in a way that is 
broadly similar to the sockets interfaces provided in the 
Berkeley UNIX distributions.). This Java network 
"Socket" code mechanism 52 uses Operating System 
(OS) services 51 from whatever OS it is running on. 

The MarshalBuffer interface 

In the preferred embodiment the interface between 
the stubs and the MarshalBuffer interface was defined 
so that the stubs not only marshal simple primitive types 
such as char and long, but are also given control over 
how structured IDL data types were marshalled. This 
meant providing genetic MarshalBuffer methods for 
marshalling and unmarshalfing array headers and union 
discriminators. 

Putting the pieces together 

In the context of the present invention different 
applications may call objects or send data to objects 
which have implementations that are associated with 
different ORBs but in this case using ORB-independent 
code/subcontract mechanisms to determine the target 
ORB, to find a MarshalBuffer that knows how to marshal 
the data for the target implementation and to communi- 
cate with the machine containing the target implementa- 
tion. Referring now to Figure 5, the client application 
112 again issues the call on stub 112. In this instance 
however, the stub 1 1 2 sends the call to an ORB-specif ic 
code/subcontract mechanism 212 determined in the 
preferred embodiment by an indication in the objref. (An 
alternative embodiment would include some ORB-ID 
mechanism for identifying the ORB-specific code mech- 
anism required by a specific object call, where this 
ORB-ID mechanism might be specified when the object 
implementation is created and used each time this 
object is called thereafter. Those skilled in the art will 
recognize that there are many ways to identify the ORB- 
specific code required by an Object reference.) This 
ORB-specific code/subcontract mechanism 212 deter- 
mines what format is required by the target ORB and 
provides a MarshalBuffer Object 210 capable of doing 
the correct marshaling, notifying the client stub 114 of 
which MarshalBuffer Object 210 is to be used. The cli- 
ent stub 114, using this MarshalBuffer Object 210 mar- 
shals the data and sends it to the network software code 
mechanism/device 116 as before. On the server side 
118 the target ORB-specific code mechanism 214 
knows how to unmarshal the data and passes it to the 
Unmarshal Buffer 216 which in the case of a Java trans- 
mission may be a virtual machine to interpret the byte- 
code data for execution by the server machine. 

In the preferred embodiment, for any IDL object ref- 
erence of type FOO. we provide a Java stub class FOO 
that consists of a set of stub methods and pointer to a 
subcontract object that contains information identifying 
the server object. Each object of the stub class will point 
to a different subcontract object, and these subcontract 
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objects may have different implementations, allowing 
them to talk to different ORBS. When the stub methods 
wish to make an object invocation they ask the subcon- 
tract to give them a suitable MarshalBuffer object and 

s then use that MarshalBuffer to marshal the arguments 
and unmarshal the results. An exemplary MarshalBuffer 
is shown in Figure 6. The MarshalBuffer interface 
shown in Figure 6 represents a clean separation 
between the functionality of the ORB dependent code in 

io marshaling and unmarshalling data. The stubs under- 
stand the particular set of arguments or results that are 
required for a particular IDL call. The stubs then call into 
the ORB dependent code mechanism that implements 
the MarshalBuffer interface in order to marshal (or 

75 unmarshal) each data item contained in the arguments 
or results. The ORB dependent code mechanism knows 
nothing about the IDL interface but simply marshals 
each data item in the correct format for that target ORB. 
Key concepts in the preferred embodiment are that (1) 

20 the MarshalBuffer interface such as shown in Figure 6 
is an interface which different ORBs can provide their 
own implementation for, and (2) the ORB dependent 
code provides the MarshalBuffer object to the stubs. 
So for example, referring now to Figure 7 an object 

25 reference of IDL type FOO 404 that points at a Spring 
server (not illustrated) might use Spring's Singleton 
subcontract 408. When the stubs for FOO 406 come to 
make a call on one of the FOO methods they first ask 
the subcontract 408 to give them a MarshalBuffer. The 

30 Singleton subcontract 408 will return a Spring Marshal- 
Buffer 410 that will obey the Spring on-the-wire data for- 
mats. The stubs 406 then marshal the method 
arguments into that marshal buffer 410. After the stubs 
406 have marshalled all the arguments, they call into 

35 the Subcontract 408 to actually transmit the method 
invocation to the server. The Singleton subcontract 408 
uses the Spring network protocol handlers 412 to trans- 
mit the request to the Spring server and get the results. 
The stubs 406 can then unmarshal the results from the 

40 MarshalBuffer 41 0 and return them to the client applica- 
tion 402. 

In the preferred embodiment, a stub compiler 
contojava that generates complete Java client stubs for 
IDL interfaces is used. 

45 In addition, a working Java ORB implementation 
that can communicate with both DOE and Spring serv- 
ers is used. The code for talking to Spring includes two 
subcontracts (Caching and Singleton) and a Java imple- 
mentation of Spring's proxy-proxy protocol. The code for 

so talking to DOE includes a single subcontract (for the 
Basic Object Adapter (BOA)) and code for locating and 
activating DOE BOA objects. All of this ORB code is 
written in Java and is portable between different Java 
environments. It is believed that this ORB core could be 

55 easily extended with subcontracts that could talk to 
UNO or to ORBs implemented by other vendors. 

While the invention has been described in terms of 
a preferred embodiment in a specific operating system 
environment, those skilled in the art will recognize that 
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the invention can be practiced, with modification, in 
other and different operating systems within the spirit 
and scope of the appended claims. 

Claims 5 

1 . A computer system having a processor, a memory, 
a display device, an input/output device, an operat- 
ing system (OS), for processing program code 
mechanism invocations which are directed to one 10 
of a multiplicity of remote Object Request Brokers 
(ORBs), the computer system comprising: 

an ORB independent layer of code mecha- 
nisms including program applications and is 
related stubs; and 

an ORB dependent layer of code mechanisms, 
coupled to the ORB independent layer, the 
ORB dependent layer comprising 

20 

program code mechanisms which are 
ORB-specific and which are configured to 
generate a marshal code mechanism to 
marshal data in an ORB required format 
and. 25 
program code mechanisms configured to 
use a specific network protocol code 
whereby a program application code 
mechanism from the ORB independent 
layer can invoke a call on a remote imple- 30 
mentation program code mechanism and 
the ORB-specific program code mecha- 
nisms in the ORB dependent layer will 
determine an appropriate marshal code 
mechanism to marshal data in an ORB 35 
required format ; 

thereby providing a computer system capa- 
ble of communicating with a multiplicity of ORBs 
wherein each ORB requires data to be in a specific 40 
format. 

2. A computer system as defined in claim 1 wherein 
the ORB independent layer of code mechanisms 
including program applications and related stubs 45 
comprise object applications and related stubs. 



A computer system as defined in claim 1 wherein 
the marshal code mechanism to marshal data in an 
ORB required format which is located in the ORB - 
dependent layer is a MarshalBuffer Object config- 
ured to execute operations to marshal data in an 
ORB specific format. 



A computer system as defined in claim 1 wherein 
the program code mechanism configured to use a 
specific network protocol code communicates with 
a server computer comprising: 
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a receiving program code mechanism compris- 
ing ORB dependent code configured to receive 
an object invocation from a remote computer 
system: and 

an ORB independent server application 
whereby the receiving program code mecha- 
nism calls into the ORB independent server 
application, passing in a MarshalBuffer that 
allows the server application to unmarshal 
arguments and marshal results without having 
to know which ORB a call came from. 

A multi-ORB marshaling system for use in a com- 
puter node which contains client applications and 
related stubs for communicating with remote com- 
puter nodes which contain object implementations, 
the multi-ORB marshaling system comprising: 

an ORB-specific program code mechanism 
configured to receive an invocation of a target 
object implementation by an invoking client 
application, the invocation being received from 
a stub related to the invoking client application, 
wherein the invoking client application and the 
related stub have no knowledge of an ORB 
which must process the invocation, the ORB- 
specific program code mechanism configured 
to select one of a multiplicity of MarshalBuffer 
program code mechanisms: and 
a MarshalBuffer program code mechanism, 
coupled to said ORB-specific program code 
mechanism configured to receive an invocation 
of a target object implementation, said Mar- 
shalBuffer program code mechanism config- 
ured to marshal arguments and data into a 
specific format required by the ORB which 
must process the invocation. 

A MarshalBuffer program code mechanism for use 
in a computer node which contains client applica- 
tions and related stubs for communicating with 
remote computer nodes which contain object imple- 
mentations, the MarshalBuffer program code mech- 
anism comprising: 

program code mechanisms configured to for- 
mat arguments and data related to an object 
implementation invocation made by a client 
application, wherein said invocation and said 
client application have no knowledge of an 
ORB which can process said invocation and 
wherein said invocation and said client applica- 
tion have no knowledge of a data format 
required by said ORB which can process said 
invocation. 

A method of operating a computer system having a 
processor, a memory, a display, an input/output 
mechanism, an operating system and at least one 
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client application program, one or more stub pro- 
grams related to the client application, the method 
performed by the computer comprising the steps of: 

invoking a call on a program implementation s 
code mechanism, the call invocation being 
made by a client application wherein the call 
includes a reference to the program implemen- 
tation code mechanism; 

using a stub program code mechanism which 10 
is related to the client application to receive the 
call invocation, wherein the stub program code 
mechanism has no knowledge of a format 
required for marshaling data provided by the 
client application in connection with the call 75 
invocation; 

calling a first specific program code mecha- 
nism by the stub program code mechanism, 
requesting the first specific program code 
mechanism to provide a MarshalBuffer code 20 
mechanism that knows how to format data pro- 
vided by the client application in connection 
with the call invocation; 

marshaling the data provided by the client 
application in connection with the call invoca- 25 
tion, the marshaling being done by the stub 
program code mechanism using the Marshal- 
Buffer code mechanism; and 
sending the call invocation to a server contain- 
ing the program implementation code mecha- 30 
nism which is the target of the call. 

8. The method described in claim 7 comprising the 
additional step of unmarshalling results from the 
MarshalBuffer, the results supplied by the program 35 
implementation code mechanism which was called 

by the invocation. 

9. The method described in claim 7 wherein the first 
specific program code mechanism called by the 40 
stub program code mechanism is an Object 
Request Broker (ORB) specific code mechanism, 

1 0. The method described in claim 8 wherein the stub 
program code mechanism which calls the ORB 45 
specific code mechanism has no knowledge of the 
ORB which will process the call. 

11. The method described in claim 7 wherein the 
Object Request Broker (ORB) is an Object Man- so 
agement Group (OMG) Common Object Request 
Broker (CORBA) compliant ORB. 

12. A computer program product comprising a compu- 
ter system usable storage medium having compu- 55 
ter readable code embodied therein for causing a 
computer system to process program code mecha- 
nism invocations which are directed to one of a mul- 
tiplicity of remote Object Request Brokers (ORBs), 



the computer program product comprising: 

a first computer readable program code mech- 
anism configured to comprise an ORB-inde- 
pendent layer of code mechanisms including 
client applications and related stub program 
code mechanisms ; and 

a second computer readable program code 
mechanism configured to comprise an ORB 
dependent layer of code mechanisms, coupled 
to the ORB independent layer, the ORB 
dependent layer comprising program code 
mechanisms which are ORB-specific and 
which are configured to generate a marshal 
code mechanism to marshal data in an ORB 
required format and program code mecha- 
nisms configured to use a specific network pro- 
tocol code whereby a program application code 
mechanism from the ORB independent layer 
can invoke a call on a remote implementation 
program code mechanism and the ORB-spe- 
cific program code mechanisms in the ORB 
dependent layer will determine an appropriate 
marshal code mechanism to marshal data in an 
ORB required format. 

thereby providing a computer system capa- 
ble of communicating with a multiplicity of ORBs 
wherein each ORB requires data to be in a specific 
format. 

13. A computer program product as defined in claim 12 
wherein the ORB independent layer of code mech- 
anisms including program applications and related 
stubs comprise object applications and related 
stubs. 

14. A computer program product as defined in claim 12 
wherein the marshal code mechanism to marshal 
data in an ORB required format which is located in 
the ORB - dependent layer is a MarshalBuffer 
Object configured to execute operations to marshal 
data in an ORB specific format 

1 5. A computer program product as defined in claim 12 
wherein the program code mechanism configured 
to use a specific network protocol code which is 
located in the ORB • dependent layer is configured 
to use a network protocol code mechanism 
selected from a group consisting of Spring network 
protocol code and DOE network protocol code. 

16. A computer program product as defined in claim 12 
wherein the marshal code mechanism to marshal 
data in an ORB required format which is located in 
the ORB - dependent layer is also configured to 
unmarshal results returned to it. 

17. A method for use in a computer node which con- 
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tains client applications and related stubs for com- 
municating with remote computer nodes which 
contain object implementations wherein the compu- 
ter implementations require invocation data to be in 
specific formats, the method, performed by the 
computer, comprising the steps of: 



server application to unmarshal arguments and 
marshal results without having to know which 
ORB a call came from. 



using an Object Request Broker (ORB)-spe- 
crfic program code mechanism configured to 
receive an invocation of a target object imple- io 
mentation by an invoking client application, the 
invocation being received from a stub related to 
the invoking client application, wherein the 
invoking client application and the related stub 
have no knowledge of an ORB which must is 
process the invocation, the ORB-specific pro- 
gram code mechanism configured to select 
one of a multiplicity of Marshal Buffer program 
code mechanisms; and 

using a Marshal Buffer program code mecha- 20 
nism configured to marshal arguments and 
data into a specific format required by the ORB 
which must process the invocation. 



18. A method for marshaling data into a specific format 25 
for use in a computer node which contains client 
applications and related stubs for communicating 
with remote computer nodes which contain object 
implementations, the method for marshaling data, 
performed by a computer, comprising the steps of: 30 



providing marshal program code mechanisms 
configured to format arguments and data 
related to an object implementation invocation 
made by a client application, wherein said invo- 35 
cation and said client application have no 
knowledge of an Object Request Broker (ORB) 
which can process said invocation and wherein 
said invocation and said client application have 
no knowledge of a data format required by said 40 
ORB which can process said invocation; and 
using said marshal program code mechanisms 
to marshal and unmarshal said arguments and 
data. 

45 

19. A computer system as defined in claim 1 wherein 
the ORB • dependent layer is also independent of 
the Operating System (OS) layer. 

20. The method of claim 7 comprising the additional so 
steps of: 

receiving an object invocation from a remote 
computer system by a server-side ORB 
dependent code mechanism; and 55 
issuing a call into an ORB independent server 
application, the call made by the server-side 
ORB dependent code mechanism which 
passes in a MarshalBuffer that allows the 
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// 

// MorshallBuffer describes a set of arguments or results to or from 
// on IDL coll 

// 

package OP; 

public interface MarshalBuffer } 

byte qetByte 0 throws CORBA.SystemException; 

byte [J getbytes (int len) throws CORBA.SystemException; 

short getShort () throws CORBA.SystemException; 

mt getlnt () throws CORBA.SystemExceptfc>n; 

long getLong 0 throws CORBA-SystemException; 

char getChar () throws CORBA.SystemException; 

char [] getChars (int len) throws CORBASystemException; 

boolean getBool Q throws CORBA.SystemException; 

String getString () throws CORBA.systemException; 

float getFloot Q throws CORBA.SystemException; 

double getOouble () throws CORBA.SystemException; 

public OP.SequenceHeoder getSequencePreomble () throws CORBA.SystemException; 

void putByte (byte X) throws CORBA.SystemException; 

void putBytes (byte x []) throws CORBA.SystemException; 

void putShort (short x) throws CORBA.SystemException; 

void putlnt (int x) throws CORBASystemException; 

void putLong flong x) throws CORBA.SystemException; 

void putChor (chor x) throws CORBA.SystemException; 

void putChors (char x (]) throws COR8A.SystemException; 

void putString (String x) throws CORBA.SystemException; 

void putBool (boolean x) throws CORBA.SystemException- 

void putRoat (float x) throws CORBA.SystemException; 

void putDouble (double x) throws CORBA.SystemException; 

public void putSequencePreamble (int length) throws CORBA.SystemException; 

void putNull () throws CORBA.SystemException; 
-^void unmorshaLobject (CORBACORBA^Obiect.Object ref) throws CORBA.SystemException; 

//Releose meons the MarshalBuffer con discard or recycle its contents, 
void release (); 

//reset means that the marshal buffer should be put back into the same 
//state as a newly constructed MarshalBufffer 
void reset () throws CORBA.SystemException; 

FIG. 6 
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jf Moreno IIBuf to describes a set of arguments or results lo or from 
//on IDL call 



public intwfcce Marshal Buffer ] 

byte getByte () throws CORBA-SytfimExcflption; 
byte [] getb/tss (int ten) thf©w9 CORBA.SystemExceptign; 
short getShort () throws CQRBA.Syatern£}cceptiDn; 
int gellni Q throws CQRBA,SystemEj(Mption; 
long g«tLong () throw* CORBA.S}rltemException; 
Dhor MtChor (} throws CQRbXSyBlttnExceptioru 
char (] getChors (int len) throw CORBA,SystemExoept1tm; 
boolean getBool Q throws CORBA.SystemE«cBption; 



Moot getFloat () throws CORBA-Syst^mException; 
double getDouble Q throws COfmSystirnfxc«ption; 
*■ public OP.SequenceHender getSeqtrencePrwmble 0 throws O0RBA.Systom Exception; 

void putByle (byte x) throws CORBLSystsmbieeption; 
void put Bytes (byte x □) threw* CQRBA-SyjtemQsception; 
void putShort (short x) throws CORBA.5y9temEx«ptiori; 
void putlnt {int *) throws CrjReX5y$temE*cepticin; 
void putting flong x| throws OTRBrV5y9iernEj«eption; 
void putChor (chor x) throws C0fl8A.Sy3temExceplror« 
void putChors Jchar * M) throws CrjReA.SystimExcflptfon; 
void putStfflg (String x) throws CDRBkSysfom Exception; 
void put8ool (boolean x) throws OQRB^^lemERoepttori; 
void ptfFbot (float x) throw* CQRSA^Iem&oepfian; 
void putOouUe (double x) throwj CORBrVSyalemEacBation: 
*- public void pulScquencePraaiYiWe (int length) throws OQRBA^iemEjrception: 

void pwtNull (J throws CORBA.SystemExceptron: 
~void unmarshoLobjecl (C0RaA,CORB^DbjecLab>ct r»fj throws CORBA-SystemException; 

//Rfllwee meong the MarahollJuFfsr con discord or recycle Its contents, 
void relgosc Q; 

//reset means trtot the marshal buffer should be put bock into the same 
//slate qs e newly constructed Marsha IBufffer 
void roset () throws CORG^ystemExcaption; 





FIG, 6 
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